home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / wp2x110.zip / README < prev    next >
Text File  |  1991-08-20  |  3KB  |  83 lines
  1. Before installing, make sure you have...
  2.  
  3.     1.  The wp2x.c source code.
  4.     2.  As many *.cfg files as you feel like using.
  5.     3.  The manual page (wp2x.1l)
  6.     4.  An ANSI-C compiler.  At a minimum, your compiler must understand...
  7.                 function prototypes
  8.                 enums
  9.                 <stdarg.h>
  10.                 vfprintf
  11.  
  12.  
  13. Installation procedure:
  14.  
  15.     0.  Decide if you want to have a lib/wp2x directory.
  16.  
  17.         If so, define the preprocessor symbol WP2X_DIR to its name,
  18.         including double-quotation marks.  The supplied man page
  19.         assumes you have chosen the name /usr/local/lib/wp2x.
  20.         If you choose a different name, or decide not to install
  21.         one, modify the man page accordingly.
  22.  
  23.     1.  Read the section titled PORTABILITY CONCERNS in wp2x.c.
  24.         Understand it.
  25.  
  26.         If your operating system is not UNIX, MS-DOS,
  27.         or the Amiga, also read dopen.c and (if you want) create
  28.         a collection of #define's for your operating system, or live
  29.         with the `generic' configuration.
  30.  
  31.     2.  Compile wp2x.c with whatever compiler switches are necessary
  32.         to accomplish what is described in PORTABILITY CONCERNS.
  33.         See the file `HINTS' for suggestions.  If your operating
  34.         system is one of those mentioned above, define the symbol
  35.         `UNIX', `MSDOS' or `AMIGA' (respectively) to your preprocessor.
  36.  
  37.     3.  Run the torture test by uudecoding torture.uue into torture.wp,
  38.         then typing
  39.  
  40.             wp2x ascii.cfg torture.wp >torture.out
  41.  
  42.         It should produce eight warnings.
  43.  
  44.         If torture.out is not identical to torture.chk, find out
  45.     why and fix it.  (Or complain to the author.)
  46.  
  47.     3.  Put the sample *.cfg files in a vaguely obvious place.
  48.         Adjust the directory name in the man page to point to that
  49.         vaguely obvious place.
  50.  
  51.     4.  Put the executable and man page in the places such things are
  52.         kept on your system.
  53.  
  54. History:
  55.  
  56. * The first WP2X was written in Spring 1989 as a volunteer effort for the
  57.   Princeton University Computing and Information Technology Information
  58.   Center.  (How's that for a mouthful.)  People seemed to need to convert
  59.   WP4.2 files into other stuff, so I figured, hey, why not just hack one
  60.   up?  How hard can it be?
  61.  
  62.   It seemed to work fine, for the limited cases thrown at it.
  63.  
  64. * During Summer 1989, some more control codes were added and a
  65.   request for beta testers posted to the net.  Response was mild.
  66.  
  67. * During Summer 1990, yet more control codes were added, and my
  68.   beta testers from 1989 seemed to have forgotten about me, so the
  69.   testing phase was abandoned.
  70.  
  71. * During Summer 1991, I made another request for beta testers in
  72.   comp.text.tex, and responses was decent.  The result of this testing
  73.   phase is what you see before you.
  74.  
  75. Author:
  76.     Raymond Chen (raymond@math.berkeley.edu, rjc@math.princeton.edu)
  77.  
  78. Copying:
  79.     This program and its supporting files are Copyright 1991 by
  80.     Raymond Chen.  You may distribute the program freely, provided
  81.     it is distributed in its entirely, including this README file.
  82.     Any modifications to the program should be clearly marked as such.
  83.